home *** CD-ROM | disk | FTP | other *** search
/ Cream of the Crop 21 / Cream of the Crop 21 (Terry Blount) (October 1996).iso / database / dates608.zip / DATES.DOC < prev    next >
Text File  |  1996-08-31  |  24KB  |  557 lines
  1. DATES.DOC                            1                         Revised: 08-28-96
  2.  
  3. This program keeps track  of  birthdays,  anniversaries,  upcoming  events,  etc
  4. giving you advance warning so you can send out cards, leave town, etc.  Features
  5. of this program:
  6.  
  7.   * Initially defaults to showing all events happening within 14 days.
  8.   * You can set up multiple date files, each with their own day threshold;
  9.     for example, one file for birthdays, another for business meetings, etc.
  10.   * You can establish a different threshold on an event-by-event basis if
  11.     desired.
  12.   * This program can be included in your AUTOEXEC.BAT file to provide notices
  13.     every time you turn on your PC.
  14.   * You can specify dates like the "last Thursday" or the "first Monday" of
  15.     a given month.
  16.   * Month-long dates can be entered (e.g. "10/XX/XX Customer Service Month").
  17.   * Recurring dates that happen each month on the same date (e.g. "XX/14/XX
  18.     Mortgage due") can be used.
  19.   * Weekly reminders for events that happen the same weekday every week can
  20.     be used.
  21.   * Dates can be in the United States format (/DATE=mm/dd/yy) or in most other
  22.     formats (e.g. /DATE=dd-mm-yy).
  23.   * Months can be entered as sequential months (1 for January, 2 for February,
  24.     etc) or else entered as the months themselves (JAN, FEB, etc).
  25.   * Dates don't have to be padded (9/6/94, 09/06/94, and SEP/06/1994 are all
  26.     accepted).
  27.   * Dates in the future can be processed or ignored at your preference.
  28.   * The program will show you the weekday, age, and/or days until the event
  29.     if desired.
  30.   * Comment lines can be displayed if desired (e.g. "Events relating to work:").
  31.   * The program can automatically pause when done or after a set number of
  32.     lines if desired.
  33.   * Entries can be sorted before display based on their "date difference" (the
  34.     number of days before the event occurs) or in their original order.
  35.   * Decimal codes (like CR/LF) can be embedded in the display file if desired,
  36.     allowing you to change colors with in the display line or split the line
  37.     into several lines for display.
  38.  
  39. The dates input file:
  40.  
  41.   The dates file is a simple ASCII text file, created and maintained with any
  42.   text editor.  Each record should begin with a date (typically in mm/dd/yy
  43.   format) followed by a description of the event.  For example:
  44.  
  45.         05/05/93 Lucy Baines
  46.  
  47.   Blank lines or any line which begins with a colon (":") or semi-colon (";")
  48.   are ignored by the program.  Lines which begin with an asterisk ("*") are
  49.   printed verbatim (minus the asterisk); add spacing after the asterisk if you
  50.   want the lines to be indented upon display.  Note:  Comments will be ignored
  51.   if /SORT is specified.
  52.  
  53.  
  54. DATES.DOC                            2                         Revised: 08-28-96
  55.  
  56. The format for the date:
  57.  
  58.   For the date portion of the record, you have some flexibility.  By default,
  59.   the program expects dates to be in a mm/dd/yy format.  So August 5, 1993 is
  60.   "08/05/93".  Even with the "mm/dd/yy" format, however, four-digit years can
  61.   be entered if desired (e.g. "06/05/2005").
  62.  
  63.   You can change the sequence of the numbers by using the "/DATE=format" option.
  64.   For example, you can specify "/DATE=dd-mm-yy" if you want.
  65.  
  66.   Typically, most date formats will use one of the delimiters "-", ".", or "/"
  67.   between all various day, month, and year fields.  For example, /DATE=dd.mm.yy
  68.   instead of /DATE=dd.mm/dd.  If this is done, your input fields can entered in
  69.   a very flexible manner.  The routine will parse the date field based on the
  70.   delimiters and accept fields with or without padding, years with or without
  71.   the century, and alphabetic months instead of just numeric ones.  For example,
  72.   using /DATE=dd.mm.yy, all of the following September 5, 1994 events are the
  73.   same:
  74.  
  75.         05.09.94 Big event
  76.         5.9.94 Same event
  77.         5.sep.1994 Still the same thing
  78.         05.september.1994 And yet again the same event
  79.  
  80. Relative weekdays:
  81.  
  82.   If you want, you can specify a day of the month based on a relative weekday
  83.   within the month.  For example, in the United States, Thanksgiving falls on
  84.   the last Thursday in November and Father's Day is the third Sunday in June.
  85.  
  86.   If it's a relative weekday from the beginning of the month, DATES allows you
  87.   to enter these in the "day" field by using "nww" where "n" indicates the
  88.   sequence of the weekday (if you leave it off, it's presumed to be the first)
  89.   and "ww" is the first two letters of the day.  If it's a relative weekday from
  90.   the end of the month, use "Lnww" ("n" defaults to 1).
  91.  
  92.   The weekdays themselves are entered as "SU", "MO", "TU", "WE", "TH", "FR",
  93.   and "SA".
  94.  
  95.   So, for these two examples, they can be entered in your file as:
  96.  
  97.         11/LTH/XX Thanksgiving
  98.         06/3SU/XX Father's Day
  99.  
  100.  
  101. DATES.DOC                            3                         Revised: 08-28-96
  102.  
  103. Weekly reminders:
  104.  
  105.   The program can be used to display weekly reminders, which happen the same
  106.   day every week.  This is entered like this:
  107.  
  108.         xx/FR/xx It's Friday!
  109.  
  110.   In this case, the program will show you the first instance of the event no
  111.   matter what your /Ddays parameter is.  If you want the event to be shown
  112.   multiple times based on your /Ddays parameter, enter 5 relative weekday
  113.   requests instead:
  114.  
  115.         xx/1FR/xx It's Friday (showing in advance)
  116.         xx/2FR/xx It's Friday (showing in advance)
  117.         xx/3FR/xx It's Friday (showing in advance)
  118.         xx/4FR/xx It's Friday (showing in advance)
  119.         xx/5FR/xx It's Friday (showing in advance)
  120.  
  121. Dummy month, day, year parameters:
  122.  
  123.   The month, day, and year portions can be "xx" if desired.  (Obviously, they
  124.   can't be all provided as such.)
  125.  
  126.   If a day is "xx", you will be given the notice for the entire month and for 15
  127.   days before the start of the month.  For dates which vary from year to year
  128.   and which can't be done using something like "LTH" or "2MO" (primarily Easter)
  129.   you can either use the "xx" option for the day or revise the file every year.
  130.  
  131.   If a month is "XX", the date is presumed to recur each month.  For example,
  132.   "XX/10/XX Mortgage due" or "XX/3TH/XX Monthly Alanon meeting".
  133.  
  134. Which dates will show up (the /Ddays parameter):
  135.  
  136.   There's a default age threshold which determines what entries in your dates
  137.   file(s) will show up.  (Using multiple dates files--each with their own date
  138.   threshhold--is documented below.) By default, any event coming due in the next
  139.   14 days will show up when the program is run.
  140.  
  141.   Dates with explicitly coded years which are in the future will, by default,
  142.   not show up.  If you'd like to add the next five years of specific dates for
  143.   the family reunion in Hoboken, you can do so and only the next one will
  144.   potentially show up.  This can be overridden using the "/-FUTURE" parameter.
  145.  
  146.   Additionally, you can specify age thresholds on an event-by-event basis by
  147.   beginning the relevant descriptions with "/Ddays" (e.g.  "11/01/95 /D60 BIG
  148.   meeting!").  Specific age thresholds like this are not overridden by the
  149.   "/Ddays" parameter specified from the command line.  There are other
  150.   parameters which can be imbedded in the input file; see the "Other
  151.   event-by-event parameters" section below.
  152.  
  153.  
  154. DATES.DOC                            4                         Revised: 08-28-96
  155.  
  156. How the dates are actually displayed:
  157.  
  158.   As far as the actual display of the information is concerned, each event is
  159.   typically presented as just "date event", where any relative day references
  160.   like "4TH" get resolved before the date is shown.  For example, presume it's
  161.   May 25 in 1994, /D14 is in effect, and your input file has the following three
  162.   lines:
  163.  
  164.         05/28/30 Mr.Fury
  165.         05/LMO/xx Memorial Day
  166.         05/31/57 Bruce Guthrie
  167.  
  168.   The initial display settings are /DATE /-DAY /-AGE /-CTDOWN.  This presents
  169.   the information as:
  170.  
  171.         05/28/30 Mr.Fury
  172.         05/30/xx Memorial Day
  173.         05/31/57 Bruce Guthrie
  174.  
  175.   See the syntax descriptions for what each of these settin